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u Bearer Access in Wireless Communication Systems 

INTRODUCTION 

5 Field of the Invention 

The invention relates to access of servers to Wireless Application Protocol (WAP) 
bearer systems. 

10 At present, it is known to provide an interface, and a development environment for 
such an interface, which allows access to Short Message Service Centres (SMSCs) 
via the (Short Message Peer-to~Peer) SMPP protocol. These products are very 
effective for the particular interfacing involved. However, many developers for 
environments such as Web server applications are unfamiliar with wireless 

15 interfacing functionality. Also, those developers who are expert in this area often 
prefer to maintain the bearer-side interfacing functionality private and avoid the 
problems associated with providing backwards and forwards compatibility and 
ensuring correct use. Such bearer developers also have the problem of testing their 
interfaces on multiple server platforms. 

20 

The invention is directed towards providing a bearer interface layer to address these 
problems. 

SUMMARY OF THE INVENTION 

25 

According to the invention, there is provided an interface layer for a wireless server 
hosting server applications, the interface layer comprising: 

a uniform interface to the wireless server, 

30 
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a bearer module interface for binding bearer modules to provide access of the 
server applications to bearer systems, and 

functions between said layers to allow server applications to make calls to 
5 connect to a bearer module and to determine status of accessible bearer 

systems. 

In one embodiment, the functions comprises a configuration manager comprising 
means for maintaining configuration data relating to bearer modules and for 
1 0 responding to server application calls for a configuration list. 

In one embodiment, the configuration manager comprises means for returning 
information regarding network type, bearer system type, and address type to server 
applications. 

15 

In one embodiment, the configuration manager comprises means for capturing 
bearer module information configured by a bearer developer within constraints of 
interfacing to the bearer module interface. 

20 In one embodiment, the configuration manager comprises means for maintaining a 
configuration file for every bound bearer module. 

In one embodiment, the functions include a bearer manager comprising means for 
registering bearer modules and for providing bearer module status information to 
25 requesting server applications. 

In one embodiment, the bearer manager comprises means for responding to server 
application calls to register a bearer module. 
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In one embodiment, the bearer manager comprises means for making a bind attempt 
to bind a bearer module to a transport mechanism. 

In one embodiment, the bearer manager comprises means for responding to 
5 application calls to disconnect from a bearer module. 

In one embodiment, the functions include a blacklist and whitelist manager 
comprising means for automatically testing all non-secure traffic. 

1 0 In one embodiment, the blacklist and whitelist manager comprises means for filtering 
traffic according to parameters set by a server application. 

In one embodiment, the functions include a callback handler comprising means for 
allowing a server application to call routines for pre-processing and post-processing 
15 of WDP packets. 

In one embodiment, the functions include a log function comprising means for 
logging test data from a bearer module under test, and for providing said data to a 
requesting server application. 

20 

In one embodiment, the functions include a billing function comprising means for 
generating billing data on the basis of criteria supplied by a server application. 

According to another aspect, the invention provides a wireless application server 
25 comprising WSP and WTP layers over an interface layer as defined above. 



DETAILED DESCRIPTION OF THE INVENTION 



Brief Description of the Drawings 

30 
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The invention will be more clearly understood from the following description of 
some embodiments thereof, given by way of example only with reference to the 
accompanying drawings in which: 

Fig. 1 is an overview diagram showing the context of an interface layer of the 
invention; 

Fig. 2 is a diagram showing the structure of the interface layer; and 
Figs. 3 and 4 are diagrams illustrating uses of the interface layer; and 
Fig. 5 is a diagram illustrating signal interactions. 
Description of the Embodiments 

Referring to Fig. 1, interface layers 1 allow access by wireless servers 2 to bearer 
systems 3. In the embodiment illustrated, the servers 2 include :- 

a WAP server 5 hosting prototype application and content, 

a WAP proxy 6 performing protocol conversion and content encoding, 

and 

a WTA server 7 hosting telephony based applications. 

The servers are connected to a Web server 8 via a Firewall 9. The bearer systems are 
in this embodiment:- 

a Circuit Switched Data bearer system 10, 
an Express Messaging SMSC bearer system 1 1, 
an SMSC bearer system 12, and 
a USSD gateway bearer system 13. 
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Referring to Fig. 2 each interface layer 1 comprises a server interface 10 to the 
applications and WTP (Wireless Transaction Protocol) layer of the server. The 
interface 10 is uniform in its interfacing operations to all of the server applications. It 
5 also comprises an interface 11 to bearer system interfacing modules 20, called 
"bearers" or "bearer modules" in this specification. Between these two interfaces 
there is: 

a bearer manager 12, 
1 0 a configuration manager 1 3 , 
a log 14, 

a callback handler 15, 
a blacklist/whitelist manager 16, 
a billing and CDR function 17, and 
1 5 an error function 18. 

The interface 10 is a uniform interface to all of the server applications and the 
interface 11 allows bearers 20 to be loaded and offers their services to the 
applications. 

20 

Referring to Fig. 3, one of the bearers 20 is a test bearer which writes to the log 14 
and the log 14 returns responses to an application 25 on a WAP stack 26. This is a 
convenient framework for creation of new bearer modules 20. It also serves to 
examine and explain the facilities offered by an existing bearer 20. It is thus very 
25 suitable for testing bearer modules 20 and allows short development times. 

Referring to Fig. 4, a WAP gateway 40 having a WAP stack 41 uses the interface 
layer 1 to access a data gateway 42 and an SMSC 43. Each of these bearer systems is 
accessed via a bearer module 20 (Bearer A and Bearer B). However the gateway 42 
30 is also accessed by a private interface 44 to be kept secret, while the SMSC is 



WO 00/74342 



PCT/IEOO/00070 



-6- 

accessed via SMPP 45 (which is public). It will thus be appreciated that the layer 1 
allows versatility in the manner in which bearer deA^elopers may link their bearer 
system with a server: a private or a public protocol may be used. All of the bearer 
modules 20 are bound by the rules of the interface 1 1, but may or may not be private 
5 on the bearer system side. This is illustrated in Fig. 4 in which there is a secret 
interface 46 and an SMPP interface 47 on the bearer system side. The following 
describes the functions between the interfaces 10 and 11 in more detail. 

Configuration manager 13 
10 The manager 13 maintains a file which specifies which bearer modules are present, 
and there is a configuration file of bearer module parameters for each bearer module. 

Bearer modules 20 

Each bearer module consists of one or more bearer files and bearer configuration 
15 files. Where possible, bearer modules are designed for dynamic loading but where 
this is not possible or not desirable static linking of bearer modules is supported. 

Bearer manager 12 

The bearer manager 12 is responsible for the loading and management of the bearer 
20 modules. It performs version checking and license checking 

Billing &CDRs 17 

This can be set to be in automatic operation to generate billing information (and pre- 
paid queries) for all non secure traffic or it can be invoked by the server application 
25 for all types of traffic. Billing is on a basis set by the server application, such as per- 
URL or per data volume. 
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White & Blacklist Manager 16 

This can be set to be in Automatic operation ' and automatically test all non-secure 
traffic, or can be invoked by a server application for required types of traffic. The 
contents of the lists are URLs or originator addresses. 

Callback Handler 15 

This allows the server application to request the layer 1 call its routines to provide 
extended pre and post processing of WDP packets. 



The calls available to the server applications are set out in the table below. 



wdc_bearer_list 


Returns the list of bearer modules 
20 configured on the server 




wdc_info 


Get information about a specific 
bearer module.20 




wdc_connect 


Connect to a bearer module 20 




wdc_send 


Send a message to the specified 
bearer system 




wdc_get 


Get a message from a specified 
bearer system 


wdc_param 


Get details of a configuration 
parameter from a configuration 
file 










wdc_log 


Create a log entry in the log/trace 
files. 
















wdc_close 


Disconnect from a bearer module. 
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The following handlers are provided to the bearer developer 



wdc_register 


Handle the registration of 
a bearer module. 




wdc_connect 


Connect to a bearer 
module. 




wdc_send 


Send a message to the 
specified bearer 




wdc _get 


Get a message from a 
specified bearer 




wdcjparam 


Get details of a 
configuration parameter 
from a configuration files 




wdc_info 


Get information about a 
specify bearer module. 




wdc_log 


Create a log entry in the 
log/trace files. 
















wdc_close 


Disconnect from a bearer 
module. 





5 Some of the above calls are illustrated in Fig. 5, in which server applications 
communicate with an SMSC bearer system for bi-directional transfer of WAP 
content. The following describes the calls in more detail, with examples of code. 



wdc_bearer_list 

10 Returns the list of bearer modules configured by the system. The call actually returns 
the value of the bearer list parameter from the wdc-dtlc.ini (layer 1 configuration file). 
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Each item in the bearer list is known as a bearer tag and can be used to retrieve 
information on that bearer using the "wdc_info" call. 

wdc-dtk.ini 
5 [main] 

Bearer_List = SMSC01, SMSCJDG, USSD, CSD23, EXP-001 

Each of the items in the list will have their own section in the ".ini" file. 
[SMSC01] 

10 bearer_modue = "smsc01/smsc3-4" 

parameter_file = "smscOl/smsc.ini" 

network = "GSM" 

bearer_type = "SMS" 

address_type = "GSM_MSISDN" 
15 assigned_number = "0x03" 

wdcjuifo 

Returns an INFO element for a connection. The information returned includes the 
20 information from the "Network Bearer table" defined by WAP. 

- Network 
Bearer type 

- Address Type 

- Assigned Number 

25 

A connection is not required to obtain information about the bearer. 

When a new bearer module 20 is being created a handler for each of the above calls 
is provided. How the call is implemented is decided by the developer of each bearer 
30 module within the constraints imposed by the interface 11. For example a developer 
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can chose to implement the "wdc_parm" handler to read from a flat file, to read from 
a database or to permanently return a blank value. 

wdc_register 

This is called by the application to load/register a specific bearer module. One of the 
parameters passed in the version identifier of the interface to ensure that only 
modules of a correct or later version are loaded. If the layer 1 locates an older 
version of the bearer module then that which it expects an error is returned. 

wdc_connect 



This function is used by the application to connect to a bearer. It makes an 
application layer connection to the bearer. The bearer module should, on a 'bind', 
15 attempt to connect/bind to the transport mechanism to ensure it is in place. If an 
application wants to connect to multiple bearer systems, say USSD and SMS, then it 
must make multiple bind calls: 

socket = wdc_connect(bearer); 
20 e.g. 

socketSMS = wdc_connect(GSM_SMS); 
Returns 

Success: This function returns a non-NULL connection identified which will be used 
25 by all further call to this bearer until the connection is terminated. 

Failure: The function returns null and stores an error in the global error number 
variable. 

30 wdc_closc 
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This tells the bearer module that the server application is disconnecting. All 
resources allocated to using the bearer should be freed. 

5 wdc_close(socketSMS); 

wdc_send 

Is used to send information to a data gateway via a bearer module using the layer 1 . 
1 0 wdc__get 

Is used to read information from a data gateway via a bearer module using the layer 
1. 

wdc_log 

15 

wdcJog(socket, severity, msg); 
An example is: 

wdc_log(socketSMS, WARNING, "Less the 10 % Memory remaining/'); 

20 Regarding billing and prepaid queries, one of the areas the layer 1 simplifies is the 
complex area of interfacing to telecom billing and prepaid systems. It is possible for 
an application to instruct the layer 1 to load and enable a billing sub module. The 
application may chose to enable the layer 1 to automatically log location URL 
and/or Volume of data as CRD for billing. This is only possible for WAP if the non- 
25 secure port is used. 

Wdc_cdr_mode(setting) 

- VOLUME 

- URL 
30 - OFF 
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The INI setting "billing__module" points to the location of the billing module to load. 
The application may call the layer 1 to create CDRs. 

5 

wdc_cdr_volume(CDR_HEADER, 400); 
Log 400 bytes 

wdc_cdr_url(CDR_HEADER, "http://www.wapforum.com/index.wmr); 

10 

Other calls include Whitelist and Blacklist management, in which an application 
may enable automatic Black/White list checking. The application may call the layer 
1 to check a URL against the Black/While list using : 

1 5 wdc_check_mode(ON/OFF); 

wdc_check_url(check_interface , url) ; 

The INI parameter: 

20 

"Black_while_list" indicates the file to use. 
wdcjparm 

25 This is used by applications for parameter reading: 

err_code_t wdc_parm(bearer_tag, wdc_param_t, ^parameter); 

typedef struct 

{ 

30 char name [WD C_P ARAM_N AME_SIZE] ; 

char value[WDC_PARAM_VALUE_SIZE]; 
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} wdc_pararm_t; 

This call is used to get a value of a configuration parameter from one of the 
configuration files. The wdcjmodule parameter selects which of the module - 
5 MAIN or one of the bearers is queried. Having a separate configuration file for each 
bearer module is necessary to prevent naming conflicts when bearer modules are 
provided by third parties. 

RETURNS 

10 Success: The function returns and ERR_OK and the value of the parameter is placed 
in the value field of the structure. 

Failure: The function returns a non-zero error number. 

1 5 Callbacks are provided by the layer 1 to allow an application request that it handles 
various events: 

wdc_callback(item, handler) 

20 ERROR - allows the application register its own handler for error conditions this is 
useful it the application already has an error logging facility that it wishes to use. 

LOG - allow an application to register its own handler for logging messages. 

25 It will be appreciated that the invention provides for excellent versatility for both 
bearer-side and server-side development. The interface layer 1 also allows the 
addition of new bearers as they become available, and the application to utilise 
intelligent' selection of bearers. 



30 The invention is not limited to the embodiments described, but may be varied in 
construction and detail. 
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Claims 

1. An interface layer for a wireless server hosting server applications, the interface 
layer comprising: 

a uniform interface (10) to the wireless server, 

a bearer module interface^ 1) for binding bearer modules (20) to provide access 
of the server applications to bearer systems, and 

functions between said layers to allow server applications to make calls to 
connect to a bearer module and to determine status of accessible bearer 
systems. 

2. An interface layer as claimed in claim 1, wherein the functions comprises a 
configuration manager comprising mean for maintaining a configuration file of 
bearer modules and for responding to server application calls for a 
configuration list. 

3. An interface layer as claimed in claim 2, wherein the configuration manager 
comprises means for returning information regarding network type, bearer 
system type, and address type to server applications. 

4. An interface layer as claimed in claim 3, wherein the configuration manager 
comprises means for capturing bearer module information configured by a 
bearer developer within constraints of interfacing to the bearer module 
interface. 
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5. An interface layer as claimed in claims 2 to 4, wherein the configuration 
manager comprises means for maintaining a configuration file for every bound 
bearer module. 

6. An interface layer as claimed in any preceding claim wherein the functions 
include a bearer manager comprising means for registering bearer modules and 
for indicating bearer module status. 

7. An interface layer as claimed in claim 6 ; wherein the bearer manager comprises 
means for responding to server application calls to register a bearer module. 

8. An interface layer as claimed in claim 7, wherein the bearer manager comprises 
means for making a bind attempt to bind a bearer module to a transport 
mechanism. 

9. An interface layer as claimed in claims 6, 7, or 8 wherein the bearer manager 
comprises means for responding to application calls to disconnect from a bearer 
module. 

10. An interface layer as claimed in any preceding claim, wherein the functions 
include a blacklist and whitelist manager comprising means for automatically 
testing all non-secure traffic. 

11. An interface layer as claimed in claim 10, wherein the blacklist and whitelist 
manager comprises means for filtering traffic according to parameters set by a 
server application. 

12. An interface layer as claimed in any preceding claim wherein the functions 
include a callback handler comprising means for allowing a server application 
to call routines for pre-processing and post-processing of WDP packets. 
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13. An interface layer as claimed in any preceding claim, wherein the functions 
include a log function comprising means for logging test data from a bearer 
module under test, and for providing said data to a requesting server 
application. 



14. An interface layer as claimed in any preceding claim, wherein the functions 
include a billing function comprising means for generating billing data on the 
basis of criteria supplied by a server application. 



15. A wireless application server comprising a WSP and WTP layers over an 
interface layer as claimed in any preceding claim. 
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